home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-Update.iso / CDROM / Contents / Naming Convention < prev    next >
Encoding:
Text File  |  1998-03-09  |  3.9 KB  |  102 lines
  1.                    The files on Peanuts
  2.                      =========================
  3.  
  4. (This file will be outdated when the OpenStep and Rhapsody file naming
  5. conventions are publicly announced in March)
  6.  
  7. The files are compressed with GNU-zip (*.gz) and tar-ed with GNU-tar
  8. or with normal unix tar (*.tar). You may want to get and install
  9. GNU-zip first. A precompiled and ready-to-run version of GNU-zip is in
  10. Unix/archiver/gzip.1.2.3.NI.b.tar
  11.  
  12. For almost every program package, a description file called
  13. [NameOfPackage].README or [NameOfPackage].[versionNumber].README
  14. exist. The binaries in the archive are available for different
  15. architectures. NeXTStep is available on 68k processors ('black
  16. hardware'), on Intel 486 and Intel pentium processors ('white
  17. hardware'), on HP/PA and on SUN SPARC architecture. 
  18.  
  19. The file names follow the convention:
  20.  
  21. NameOfPackage.[version].[architecture].[distribution].[archivers]
  22.  
  23.  version:       the release and/or version number of the program
  24.  architecture:  if the archive contains binaries, for which architecture?
  25.  distribution:  what does the archive contain? source, binary, both?
  26.  archivers:     file-extensions of the archive program(s)
  27.  
  28. version
  29. =======
  30. The version number can have different formats. Usually it consists of 
  31. the release and the version number (e.g. 1.04). Release numbers with 0 
  32. are normally beta releases (e.g. 0.13) Some packages also use a 
  33. version number like 920904 or 20.Feb.1993 indicating the date of their 
  34. release. If there is no version number mentioned, it is the first and 
  35. only release so far.
  36.  
  37. architecture
  38. ============
  39. The architecture of the binary is a combination of currently up to 4 
  40. letters in a fixed order (NIHS):
  41.  
  42.     N    NeXT m68k ('black hardware')
  43.     I    Intel 486 and Intel Pentium processor ('white Hardware')
  44.     H    HP/PA architecture from HP ('green hardware')
  45.     S    SPARC architecture from SUN ('yellow hardware')
  46.     P    PowerPC architecture by Apple, Motorola, IBM
  47.  
  48. The binary is a Multi-Architecture-binary (MAB) or FAT-binary, if it 
  49. contains code, running on two or more architectures.
  50.  
  51. distribution
  52. ============
  53. The contents of the archive. A combination of up to 4 letters, also in 
  54. fixed order (bsda):
  55.  
  56.     b    binaries for the architectures mentioned under 'architecture'
  57.     s    sources included. The sources may (!) compile on every platform
  58.     d    data file: non-executable binary, source or any other file
  59.     a    library included. The library is for the specified architecture
  60.         
  61. The 'd' and 'a' are informal. They are normally only included, when 
  62. there are additional files (libraries, sound etc.) beside the binaries 
  63. or sources in the archive.
  64.  
  65. archivers 
  66. =========
  67. The extension specifying the programs utilized for archiving and 
  68. compressing of the files. 
  69.  
  70.     tar         GNU-tar or normal unix tar
  71.     gz          GNU-zip
  72.     Z           normal unix compress
  73.     tgz         a shortcut for GNU-tar and GNU-zip together
  74.     compressed  archived and compressed using the NeXT workspace
  75.         
  76. NOTE: 'Z' and 'compressed' are not supported on this archive! The 
  77. usual case therefore is '*.tar', '*.gz' or '*.tar.gz' aka '*.tgz'. 
  78. However these extensions may occur in the NeXTanswers directory which 
  79. is a mirror of the FTP archive by NeXT.
  80.  
  81. operation system
  82. ================
  83. Newer OpenStep programs and Rhapsody programs are no longer fixed to
  84. the NeXT operation system which is using 'Mach'. Theser programs may also
  85. run under Windows 95/NT, Solaris, MacOS and Mach. Therefore another key
  86. letters are introduced in the OpenStep and Rhapsody folders:
  87.  
  88.      m           Mach (OPENSTEP for Mach, aka OPENSTEP 4.x)
  89.      w           Windows (OPENSTEP Enterprise)
  90.      a           MacOS
  91.      s           Solaris
  92.  
  93. Examples:
  94. =========
  95.  
  96.     tarZan.1.0.N.bs.tar.gz
  97.     Columns.2.97.N.b.tar.gz
  98.     DrivePerformance.1.1.NI.b.tar.Z
  99.         OmniWeb.3.0b4.m.PI.tgz (Mach OS, for PowerPC and Intel, Gnutar
  100.                                 compressed)
  101.  
  102.